<HTML><HEAD><META CONTENT="text/html; charset=UTF-8" HTTP-EQUIV="Content-Type"/><TITLE>EMMA Coverage Report</TITLE><STYLE TYPE="text/css"> TABLE,TD,TH {border-style:solid; border-color:black;} TD,TH {background:white;margin:0;line-height:100%;padding-left:0.5em;padding-right:0.5em;} TD {border-width:0 1px 0 0;} TH {border-width:1px 1px 1px 0;} TR TD.h {color:red;} TABLE {border-spacing:0; border-collapse:collapse;border-width:0 0 1px 1px;} P,H1,H2,H3,TH {font-family:verdana,arial,sans-serif;font-size:10pt;} TD {font-family:courier,monospace;font-size:10pt;} TABLE.hdft {border-spacing:0;border-collapse:collapse;border-style:none;} TABLE.hdft TH,TABLE.hdft TD {border-style:none;line-height:normal;} TABLE.hdft TH.tl,TABLE.hdft TD.tl {background:#6699CC;color:white;} TABLE.hdft TD.nv {background:#6633DD;color:white;} .nv A:link {color:white;} .nv A:visited {color:white;} .nv A:active {color:yellow;} TABLE.hdft A:link {color:white;} TABLE.hdft A:visited {color:white;} TABLE.hdft A:active {color:yellow;} .in {color:#356085;} TABLE.s TD {padding-left:0.25em;padding-right:0.25em;} TABLE.s TD.l {padding-left:0.25em;padding-right:0.25em;text-align:right;background:#F0F0F0;} TABLE.s TR.z TD {background:#FF9999;} TABLE.s TR.p TD {background:#FFFF88;} TABLE.s TR.c TD {background:#CCFFCC;} A:link {color:#0000EE;text-decoration:none;} A:visited {color:#0000EE;text-decoration:none;} A:hover {color:#0000EE;text-decoration:underline;} TABLE.cn {border-width:0 0 1px 0;} TABLE.s {border-width:1px 0 1px 1px;} TD.h {color:red;border-width:0 1px 0 0;} TD.f {border-width:0 1px 0 1px;} TD.hf {color:red;border-width:0 1px 0 1px;} TH.f {border-width:1px 1px 1px 1px;} TR.cis TD {background:#F0F0F0;} TR.cis TD {border-width:1px 1px 1px 0;} TR.cis TD.h {color:red;border-width:1px 1px 1px 0;} TR.cis TD.f {border-width:1px 1px 1px 1px;} TR.cis TD.hf {color:red;border-width:1px 1px 1px 1px;} TD.b {border-style:none;background:transparent;line-height:50%;}  TD.bt {border-width:1px 0 0 0;background:transparent;line-height:50%;} TR.o TD {background:#F0F0F0;}TABLE.it {border-style:none;}TABLE.it TD,TABLE.it TH {border-style:none;}</STYLE></HEAD><BODY><TABLE CLASS="hdft" CELLSPACING="0" WIDTH="100%"><TR><TH CLASS="tl"><A HREF="http://www.eclemma.org/">EMMA</A> Coverage Report (generated Thu Dec 17 17:04:35 EST 2009)</TH></TR><TR><TD CLASS="nv">[<A HREF="../Framework-12-17.html">all classes</A>][<A HREF="24.html">ks.common.games</A>]</TD></TR></TABLE><H2>COVERAGE SUMMARY FOR SOURCE FILE [<SPAN CLASS="in">Solitaire.java</SPAN>]</H2><TABLE CELLSPACING="0" WIDTH="100%"><TR><TH>name</TH><TH>class, %</TH><TH>method, %</TH><TH>block, %</TH><TH>line, %</TH></TR><TR><TD>Solitaire.java</TD><TD>100% (1/1)</TD><TD CLASS="h">43%  (16/37)</TD><TD CLASS="h">48%  (165/346)</TD><TD CLASS="h">47%  (52/111)</TD></TR></TABLE><H3>COVERAGE BREAKDOWN BY CLASS AND METHOD</H3><TABLE CLASS="cn" CELLSPACING="0" WIDTH="100%"><TR><TH CLASS="f">name</TH><TH>class, %</TH><TH>method, %</TH><TH>block, %</TH><TH>line, %</TH></TR><TR><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD></TR><TR CLASS="cis"><TD CLASS="f">class <A HREF="#0">Solitaire</A></TD><TD>100% (1/1)</TD><TD CLASS="h">43%  (16/37)</TD><TD CLASS="h">48%  (165/346)</TD><TD CLASS="h">47%  (52/111)</TD></TR><TR><TD CLASS="f"><A HREF="#1">getIncrement (): int</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/3)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#2">getModelElement (String): Element</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/12)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR><TD CLASS="f"><A HREF="#3">getModelElements (): Enumeration</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#4">getMoves (): Enumeration</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR><TD CLASS="f"><A HREF="#5">getNumLeft (): MutableInteger</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/3)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#6">getScore (): MutableInteger</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/3)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR><TD CLASS="f"><A HREF="#7">getScoreValue (): int</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#8">getSeed (): int</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/3)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR><TD CLASS="f"><A HREF="#9">getVersion (): String</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/2)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#a">getWidgets (): Enumeration</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/12)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR><TD CLASS="f"><A HREF="#b">nextHand (): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/10)</TD><TD CLASS="h">0%   (0/3)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#c">popMove (): Move</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/11)</TD><TD CLASS="h">0%   (0/3)</TD></TR><TR><TD CLASS="f"><A HREF="#d">pushMove (Move): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/7)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#e">refreshWidgets (): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR><TD CLASS="f"><A HREF="#f">refreshWidgets (Rectangle): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/5)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#10">repaintAll (Rectangle): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/5)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR><TD CLASS="f"><A HREF="#11">repaintBackground (Rectangle): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/5)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#12">repaintWidgets (Rectangle): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/5)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR><TD CLASS="f"><A HREF="#13">undoMove (): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/24)</TD><TD CLASS="h">0%   (0/9)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#14">updateNumberCardsLeft (int): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR><TD CLASS="f"><A HREF="#15">updateScore (int): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/15)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#16">addModelElement (Element): boolean</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">58%  (7/12)</TD><TD CLASS="h">50%  (2/4)</TD></TR><TR><TD CLASS="f"><A HREF="#17">addViewWidget (Widget): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">70%  (23/33)</TD><TD CLASS="h">60%  (6/10)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#18">setNumberCardsLeft (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">71%  (15/21)</TD><TD>80%  (4/5)</TD></TR><TR><TD CLASS="f"><A HREF="#19">setScore (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">71%  (15/21)</TD><TD>80%  (4/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#1a">resetHand (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>92%  (45/49)</TD><TD>88%  (14/16)</TD></TR><TR><TD CLASS="f"><A HREF="#0">Solitaire (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (16/16)</TD><TD>100% (5/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#1c">getCardImages (): CardImages</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (8/8)</TD><TD>100% (2/2)</TD></TR><TR><TD CLASS="f"><A HREF="#1d">getContainer (): Container</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (3/3)</TD><TD>100% (1/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#1e">getDeckType (): String</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (2/2)</TD><TD>100% (1/1)</TD></TR><TR><TD CLASS="f"><A HREF="#1f">getPreferredSize (): Dimension</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (6/6)</TD><TD>100% (1/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#20">refreshAll (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (4/4)</TD><TD>100% (2/2)</TD></TR><TR><TD CLASS="f"><A HREF="#21">repaintAll (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (4/4)</TD><TD>100% (2/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#22">setContainer (Container): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (8/8)</TD><TD>100% (3/3)</TD></TR><TR><TD CLASS="f"><A HREF="#23">setIncrement (int): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (4/4)</TD><TD>100% (2/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#24">setSeed (int): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (4/4)</TD><TD>100% (2/2)</TD></TR><TR><TD CLASS="f"><A HREF="#25">updateGameInformationFromContainer (Container): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (1/1)</TD><TD>100% (1/1)</TD></TR></TABLE><P></P><TABLE CLASS="s" CELLSPACING="0" WIDTH="100%"><TR><TD CLASS="l">1</TD><TD>package ks.common.games;</TD></TR><TR><TD CLASS="l">2</TD><TD> </TD></TR><TR><TD CLASS="l">3</TD><TD>import java.awt.Dimension;</TD></TR><TR><TD CLASS="l">4</TD><TD>import java.util.Enumeration;</TD></TR><TR><TD CLASS="l">5</TD><TD> </TD></TR><TR><TD CLASS="l">6</TD><TD>import java.awt.Rectangle;</TD></TR><TR><TD CLASS="l">7</TD><TD> </TD></TR><TR><TD CLASS="l">8</TD><TD>// perhaps move this logic back into container?</TD></TR><TR><TD CLASS="l">9</TD><TD>import ks.common.controller.SolitaireMouseMotionAdapter;</TD></TR><TR><TD CLASS="l">10</TD><TD>import ks.common.controller.SolitaireReleasedAdapter;</TD></TR><TR><TD CLASS="l">11</TD><TD>import ks.common.model.Element;</TD></TR><TR><TD CLASS="l">12</TD><TD>import ks.common.model.Model;</TD></TR><TR><TD CLASS="l">13</TD><TD>import ks.common.model.Move;</TD></TR><TR><TD CLASS="l">14</TD><TD>import ks.common.model.MutableInteger;</TD></TR><TR><TD CLASS="l">15</TD><TD>import ks.common.view.CardImages;</TD></TR><TR><TD CLASS="l">16</TD><TD>import ks.common.view.CardImagesLoader;</TD></TR><TR><TD CLASS="l">17</TD><TD>import ks.common.view.Container;</TD></TR><TR><TD CLASS="l">18</TD><TD>import ks.common.view.Widget;</TD></TR><TR><TD CLASS="l">19</TD><TD> </TD></TR><TR><TD CLASS="l">20</TD><TD>/**</TD></TR><TR><TD CLASS="l">21</TD><TD> * The ultimate superclass of all Solitaire games.</TD></TR><TR><TD CLASS="l">22</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">23</TD><TD> * Each solitaire plugin is a subclass of &lt;code&gt;Solitaire&lt;/code&gt;. The most</TD></TR><TR><TD CLASS="l">24</TD><TD> * important method for developers is &lt;code&gt;initialize&lt;/code&gt; which is invoked</TD></TR><TR><TD CLASS="l">25</TD><TD> * when the game is started (or when a new hand is requested).</TD></TR><TR><TD CLASS="l">26</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">27</TD><TD> * &lt;code&gt;initialize&lt;/code&gt; must satisfy three responsibilities:</TD></TR><TR><TD CLASS="l">28</TD><TD> * &lt;ol&gt;</TD></TR><TR><TD CLASS="l">29</TD><TD> * &lt;li&gt;Initialize the model&lt;/li&gt;</TD></TR><TR><TD CLASS="l">30</TD><TD> * &lt;li&gt;Initialize the view&lt;/li&gt;</TD></TR><TR><TD CLASS="l">31</TD><TD> * &lt;li&gt;Initialize the controllers&lt;/li&gt;</TD></TR><TR><TD CLASS="l">32</TD><TD> * &lt;/ol&gt;</TD></TR><TR><TD CLASS="l">33</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">34</TD><TD> * Most &lt;code&gt;initialize&lt;/code&gt; methods will follow this suggested format:</TD></TR><TR><TD CLASS="l">35</TD><TD> * &lt;br&gt;</TD></TR><TR><TD CLASS="l">36</TD><TD> * </TD></TR><TR><TD CLASS="l">37</TD><TD> * &lt;pre&gt;</TD></TR><TR><TD CLASS="l">38</TD><TD> * &amp;lt;blockquote&amp;gt;</TD></TR><TR><TD CLASS="l">39</TD><TD> *  public void initialize() {</TD></TR><TR><TD CLASS="l">40</TD><TD> *    initializeModel(getSeed());</TD></TR><TR><TD CLASS="l">41</TD><TD> *    initializeView();</TD></TR><TR><TD CLASS="l">42</TD><TD> *    initializeControllers();</TD></TR><TR><TD CLASS="l">43</TD><TD> *  </TD></TR><TR><TD CLASS="l">44</TD><TD> *    // Prepare initial game setup.</TD></TR><TR><TD CLASS="l">45</TD><TD> *    ...</TD></TR><TR><TD CLASS="l">46</TD><TD> *  }</TD></TR><TR><TD CLASS="l">47</TD><TD> *  &amp;lt;/blockquote&amp;gt;</TD></TR><TR><TD CLASS="l">48</TD><TD> * &lt;/pre&gt;</TD></TR><TR><TD CLASS="l">49</TD><TD> * </TD></TR><TR><TD CLASS="l">50</TD><TD> * where &lt;code&gt;initializeModel&lt;/code&gt;,&lt;code&gt;initializeView&lt;/code&gt;, and</TD></TR><TR><TD CLASS="l">51</TD><TD> * &lt;code&gt;initializeControllers&lt;/code&gt; are protected methods of the plugin.</TD></TR><TR><TD CLASS="l">52</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">53</TD><TD> * &lt;b&gt;Initialize the Model &lt;/b&gt;</TD></TR><TR><TD CLASS="l">54</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">55</TD><TD> * Each solitaire plugin constructs a model of basic elements to be found in any</TD></TR><TR><TD CLASS="l">56</TD><TD> * solitaire variation -- a deck, buildable columns, a pile of cards. Each model</TD></TR><TR><TD CLASS="l">57</TD><TD> * element has a name unique to the model. In the example above, note how the</TD></TR><TR><TD CLASS="l">58</TD><TD> * &lt;code&gt;initializeModel&lt;/code&gt; takes the random seed which will be used to</TD></TR><TR><TD CLASS="l">59</TD><TD> * construct the appropriate deck shuffled using a randomized algorithm using</TD></TR><TR><TD CLASS="l">60</TD><TD> * this seed value.</TD></TR><TR><TD CLASS="l">61</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">62</TD><TD> * &lt;b&gt;Initialize the View &lt;/b&gt;</TD></TR><TR><TD CLASS="l">63</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">64</TD><TD> * Each model element can be represented by exactly one View Widget within the</TD></TR><TR><TD CLASS="l">65</TD><TD> * Container, the entity in which the solitaire plugin executes. Each View</TD></TR><TR><TD CLASS="l">66</TD><TD> * widget is placed at a specific (x,y) location within the coordinates of the</TD></TR><TR><TD CLASS="l">67</TD><TD> * container, and has a calculated width, and height. Some Widgets have</TD></TR><TR><TD CLASS="l">68</TD><TD> * additional attributes that may be set by the user.</TD></TR><TR><TD CLASS="l">69</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">70</TD><TD> * &lt;b&gt;Initialize the Controllers &lt;/b&gt;</TD></TR><TR><TD CLASS="l">71</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">72</TD><TD> * The real power of a solitaire plugin is in the way controller objects are</TD></TR><TR><TD CLASS="l">73</TD><TD> * constructed and attached to View Widgets. These controllers react to various</TD></TR><TR><TD CLASS="l">74</TD><TD> * Mouse Events within the Container -- MousePress, MouseRelease, MouseDrag,</TD></TR><TR><TD CLASS="l">75</TD><TD> * MouseMove, MouseEntered, and MouseExited. The controllers manage the user's</TD></TR><TR><TD CLASS="l">76</TD><TD> * interaction with the game, and thus the way the game is played.</TD></TR><TR><TD CLASS="l">77</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">78</TD><TD> * Once a game is constructed, it becomes active within a container by adding it</TD></TR><TR><TD CLASS="l">79</TD><TD> * to the container. Each game knows its seed value, as well as the increment by</TD></TR><TR><TD CLASS="l">80</TD><TD> * which new seed values are generated with each successive hand.</TD></TR><TR><TD CLASS="l">81</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">82</TD><TD> * Each Solitaire game has several default model elements, which users can</TD></TR><TR><TD CLASS="l">83</TD><TD> * construct views onto and place at whichever (x,y) coordinates they desire:</TD></TR><TR><TD CLASS="l">84</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">85</TD><TD> * &lt;ol&gt;</TD></TR><TR><TD CLASS="l">86</TD><TD> * &lt;li&gt;numberLeft -- MutableInteger&lt;/li&gt;</TD></TR><TR><TD CLASS="l">87</TD><TD> * &lt;li&gt;score -- MutableInteger&lt;/li&gt;</TD></TR><TR><TD CLASS="l">88</TD><TD> * &lt;/ol&gt;</TD></TR><TR><TD CLASS="l">89</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">90</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">91</TD><TD> * Creation date: (10/1/01 11:35:04 PM)</TD></TR><TR><TD CLASS="l">92</TD><TD> * </TD></TR><TR><TD CLASS="l">93</TD><TD> * @author George Heineman (heineman@cs.wpi.edu)</TD></TR><TR><TD CLASS="l">94</TD><TD> */</TD></TR><TR><TD CLASS="l">95</TD><TD>abstract public class Solitaire {</TD></TR><TR><TD CLASS="l">96</TD><TD> </TD></TR><TR><TD CLASS="l">97</TD><TD>        /** The Container to manager the game. */</TD></TR><TR CLASS="c"><TD CLASS="l">98</TD><TD>        protected Container container = null;</TD></TR><TR><TD CLASS="l">99</TD><TD> </TD></TR><TR><TD CLASS="l">100</TD><TD>        /** Default deck type to use. Override by subclasses. */</TD></TR><TR><TD CLASS="l">101</TD><TD>        public static final String defaultDeckType = &#34;oxymoron&#34;;</TD></TR><TR><TD CLASS="l">102</TD><TD> </TD></TR><TR><TD CLASS="l">103</TD><TD>        /** seed to use for this game. */</TD></TR><TR><TD CLASS="l">104</TD><TD>        protected int seed;</TD></TR><TR><TD CLASS="l">105</TD><TD> </TD></TR><TR><TD CLASS="l">106</TD><TD>        /** The increment to add to seed when starting a new hand. */</TD></TR><TR><TD CLASS="l">107</TD><TD>        protected int increment;</TD></TR><TR><TD CLASS="l">108</TD><TD> </TD></TR><TR><TD CLASS="l">109</TD><TD>        /** Every Solitaire game has a score named 'score'. */</TD></TR><TR><TD CLASS="l">110</TD><TD>        protected MutableInteger score;</TD></TR><TR><TD CLASS="l">111</TD><TD> </TD></TR><TR><TD CLASS="l">112</TD><TD>        /** Name of special score object. */</TD></TR><TR><TD CLASS="l">113</TD><TD>        public static final String scoreName = &#34;score&#34;;</TD></TR><TR><TD CLASS="l">114</TD><TD> </TD></TR><TR><TD CLASS="l">115</TD><TD>        /** Every Solitaire game records the number of cards left. */</TD></TR><TR><TD CLASS="l">116</TD><TD>        protected MutableInteger numLeft;</TD></TR><TR><TD CLASS="l">117</TD><TD> </TD></TR><TR><TD CLASS="l">118</TD><TD>        /** Name of special numLeft object. */</TD></TR><TR><TD CLASS="l">119</TD><TD>        public static final String numLeftName = &#34;numLeft&#34;;</TD></TR><TR><TD CLASS="l">120</TD><TD> </TD></TR><TR><TD CLASS="l">121</TD><TD>        /** Stack of recent Moves */</TD></TR><TR CLASS="c"><TD CLASS="l">122</TD><TD>        protected java.util.Stack&lt;Move&gt; moves = new java.util.Stack&lt;Move&gt;();</TD></TR><TR><TD CLASS="l">123</TD><TD> </TD></TR><TR><TD CLASS="l">124</TD><TD>        /** The Model. */</TD></TR><TR CLASS="c"><TD CLASS="l">125</TD><TD>        protected Model model = new Model();</TD></TR><TR><TD CLASS="l">126</TD><TD> </TD></TR><TR><TD CLASS="l"><A NAME="0">127</A></TD><TD>        /**</TD></TR><TR><TD CLASS="l">128</TD><TD>         * Default Constructor for Solitaire subclasses</TD></TR><TR><TD CLASS="l">129</TD><TD>         */</TD></TR><TR><TD CLASS="l">130</TD><TD>        protected Solitaire() {</TD></TR><TR CLASS="c"><TD CLASS="l">131</TD><TD>                super();</TD></TR><TR CLASS="c"><TD CLASS="l">132</TD><TD>        }</TD></TR><TR><TD CLASS="l">133</TD><TD> </TD></TR><TR><TD CLASS="l">134</TD><TD>        /**</TD></TR><TR><TD CLASS="l">135</TD><TD>         * Adds the given Model Element to the model maintained by this Solitaire</TD></TR><TR><TD CLASS="l">136</TD><TD>         * Variation.</TD></TR><TR><TD CLASS="l">137</TD><TD>         * </TD></TR><TR><TD CLASS="l">138</TD><TD>         * @exception IllegalArgumentException</TD></TR><TR><TD CLASS="l">139</TD><TD>         *                if given ModelElement is null.</TD></TR><TR><TD CLASS="l">140</TD><TD>         * @param me</TD></TR><TR><TD CLASS="l"><A NAME="16">141</A></TD><TD>         *            The Element that forms part of the Solitiare plugin model.</TD></TR><TR><TD CLASS="l">142</TD><TD>         * @return boolean whether Model Element was successfully added.</TD></TR><TR><TD CLASS="l">143</TD><TD>         */</TD></TR><TR><TD CLASS="l">144</TD><TD>        protected boolean addModelElement(Element me) {</TD></TR><TR CLASS="c"><TD CLASS="l">145</TD><TD>                if (me == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">146</TD><TD>                        throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">147</TD><TD>                                        &#34;Solitaire::addModelElement() invoked with null Element.&#34;);</TD></TR><TR><TD CLASS="l">148</TD><TD>                }</TD></TR><TR><TD CLASS="l">149</TD><TD> </TD></TR><TR CLASS="c"><TD CLASS="l">150</TD><TD>                return model.addElement(me);</TD></TR><TR><TD CLASS="l">151</TD><TD>        }</TD></TR><TR><TD CLASS="l">152</TD><TD> </TD></TR><TR><TD CLASS="l">153</TD><TD>        /**</TD></TR><TR><TD CLASS="l">154</TD><TD>         * Adds the given Widget to the view maintained by this Solitaire Variation.</TD></TR><TR><TD CLASS="l">155</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">156</TD><TD>         * Make sure that you have the container remove all widgets before</TD></TR><TR><TD CLASS="l">157</TD><TD>         * attempting to reinitialize a solitaire game.</TD></TR><TR><TD CLASS="l">158</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">159</TD><TD>         * Every widget being added is automatically registered with the </TD></TR><TR><TD CLASS="l">160</TD><TD>         * default undo adapter and mouseMotion adapters.</TD></TR><TR><TD CLASS="l">161</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="17">162</A></TD><TD>         * @param w</TD></TR><TR><TD CLASS="l">163</TD><TD>         *            the Widget to add to the visible solitaire plugin.</TD></TR><TR><TD CLASS="l">164</TD><TD>         */</TD></TR><TR><TD CLASS="l">165</TD><TD>        protected void addViewWidget(Widget w) {</TD></TR><TR CLASS="c"><TD CLASS="l">166</TD><TD>                if (container == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">167</TD><TD>                        throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">168</TD><TD>                                        &#34;Solitaire::addModelElement() invoked with null Container.&#34;);</TD></TR><TR><TD CLASS="l">169</TD><TD>                }</TD></TR><TR><TD CLASS="l">170</TD><TD> </TD></TR><TR CLASS="c"><TD CLASS="l">171</TD><TD>                if (w == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">172</TD><TD>                        throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">173</TD><TD>                                        &#34;Solitaire::addModelElement() invoked with null Widget.&#34;);</TD></TR><TR><TD CLASS="l">174</TD><TD>                }</TD></TR><TR><TD CLASS="l">175</TD><TD> </TD></TR><TR CLASS="c"><TD CLASS="l">176</TD><TD>                container.addWidget(w);</TD></TR><TR><TD CLASS="l">177</TD><TD>                </TD></TR><TR><TD CLASS="l">178</TD><TD>                // install default undo and mouseMotion adapters.</TD></TR><TR CLASS="c"><TD CLASS="l">179</TD><TD>                w.setUndoAdapter (new SolitaireUndoAdapter(this));</TD></TR><TR CLASS="c"><TD CLASS="l">180</TD><TD>                w.setMouseMotionAdapter(new SolitaireMouseMotionAdapter(this));</TD></TR><TR CLASS="c"><TD CLASS="l">181</TD><TD>        }</TD></TR><TR><TD CLASS="l">182</TD><TD> </TD></TR><TR><TD CLASS="l">183</TD><TD>        /**</TD></TR><TR><TD CLASS="l">184</TD><TD>         * Return the specific card images to use when calculating the dimensions</TD></TR><TR><TD CLASS="l">185</TD><TD>         * within the View.</TD></TR><TR><TD CLASS="l">186</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l"><A NAME="1c">187</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">188</TD><TD>         * @return CardImages images to use for this game.</TD></TR><TR><TD CLASS="l">189</TD><TD>         */</TD></TR><TR><TD CLASS="l">190</TD><TD>        public CardImages getCardImages() {</TD></TR><TR CLASS="c"><TD CLASS="l">191</TD><TD>                CardImages ci = CardImagesLoader.getDeck(getContainer(), getDeckType());</TD></TR><TR CLASS="c"><TD CLASS="l">192</TD><TD>                return ci;</TD></TR><TR><TD CLASS="l">193</TD><TD>        }</TD></TR><TR><TD CLASS="l">194</TD><TD> </TD></TR><TR><TD CLASS="l">195</TD><TD>        /**</TD></TR><TR><TD CLASS="l">196</TD><TD>         * Returns the Container of the game.</TD></TR><TR><TD CLASS="l"><A NAME="1d">197</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">198</TD><TD>         * @return The Container in which the solitaire variation is played.</TD></TR><TR><TD CLASS="l">199</TD><TD>         */</TD></TR><TR><TD CLASS="l">200</TD><TD>        public Container getContainer() {</TD></TR><TR CLASS="c"><TD CLASS="l">201</TD><TD>                return container;</TD></TR><TR><TD CLASS="l">202</TD><TD>        }</TD></TR><TR><TD CLASS="l">203</TD><TD> </TD></TR><TR><TD CLASS="l">204</TD><TD>        /**</TD></TR><TR><TD CLASS="l">205</TD><TD>         * Returns the increment to be used to generate the next deck for this game.</TD></TR><TR><TD CLASS="l">206</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="1">207</A></TD><TD>         * @return int increment to be used to update random seed for successive</TD></TR><TR><TD CLASS="l">208</TD><TD>         *         games.</TD></TR><TR><TD CLASS="l">209</TD><TD>         */</TD></TR><TR><TD CLASS="l">210</TD><TD>        public int getIncrement() {</TD></TR><TR CLASS="z"><TD CLASS="l">211</TD><TD>                return increment;</TD></TR><TR><TD CLASS="l">212</TD><TD>        }</TD></TR><TR><TD CLASS="l">213</TD><TD> </TD></TR><TR><TD CLASS="l">214</TD><TD>        /**</TD></TR><TR><TD CLASS="l">215</TD><TD>         * Returns the Model Element maintained by this Solitaire Variation with</TD></TR><TR><TD CLASS="l">216</TD><TD>         * desired name.</TD></TR><TR><TD CLASS="l">217</TD><TD>         * </TD></TR><TR><TD CLASS="l">218</TD><TD>         * @exception IllegalArgumentException</TD></TR><TR><TD CLASS="l">219</TD><TD>         *                if desired name is invalid (i.e., null).</TD></TR><TR><TD CLASS="l">220</TD><TD>         * @param name</TD></TR><TR><TD CLASS="l"><A NAME="2">221</A></TD><TD>         *            A String representing the name of the desired Model Element</TD></TR><TR><TD CLASS="l">222</TD><TD>         * @return The Element with the desired name, or null if not found.</TD></TR><TR><TD CLASS="l">223</TD><TD>         */</TD></TR><TR><TD CLASS="l">224</TD><TD>        public Element getModelElement(String name) {</TD></TR><TR CLASS="z"><TD CLASS="l">225</TD><TD>                if (name == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">226</TD><TD>                        throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">227</TD><TD>                                        &#34;Solitaire::getModelElement() invoked with null name.&#34;);</TD></TR><TR><TD CLASS="l">228</TD><TD>                }</TD></TR><TR><TD CLASS="l">229</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">230</TD><TD>                return model.getElement(name);</TD></TR><TR><TD CLASS="l">231</TD><TD>        }</TD></TR><TR><TD CLASS="l">232</TD><TD> </TD></TR><TR><TD CLASS="l">233</TD><TD>        /**</TD></TR><TR><TD CLASS="l">234</TD><TD>         * Returns all Model Element maintained by this Solitaire variation.</TD></TR><TR><TD CLASS="l"><A NAME="3">235</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">236</TD><TD>         * @return Enumeration of Element objects.</TD></TR><TR><TD CLASS="l">237</TD><TD>         */</TD></TR><TR><TD CLASS="l">238</TD><TD>        public Enumeration&lt;Element&gt; getModelElements() {</TD></TR><TR CLASS="z"><TD CLASS="l">239</TD><TD>                return model.elements();</TD></TR><TR><TD CLASS="l">240</TD><TD>        }</TD></TR><TR><TD CLASS="l">241</TD><TD> </TD></TR><TR><TD CLASS="l">242</TD><TD>        /**</TD></TR><TR><TD CLASS="l">243</TD><TD>         * Return all moves made so far within this game.</TD></TR><TR><TD CLASS="l">244</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l"><A NAME="4">245</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">246</TD><TD>         * @return Enumeration Move objects that make up the history of the game.</TD></TR><TR><TD CLASS="l">247</TD><TD>         */</TD></TR><TR><TD CLASS="l">248</TD><TD>        public Enumeration&lt;Move&gt; getMoves() {</TD></TR><TR CLASS="z"><TD CLASS="l">249</TD><TD>                return moves.elements();</TD></TR><TR><TD CLASS="l">250</TD><TD>        }</TD></TR><TR><TD CLASS="l">251</TD><TD> </TD></TR><TR><TD CLASS="l">252</TD><TD>        /**</TD></TR><TR><TD CLASS="l">253</TD><TD>         * Every Solitaire variation must return its name.</TD></TR><TR><TD CLASS="l">254</TD><TD>         * </TD></TR><TR><TD CLASS="l">255</TD><TD>         * @return String the name of the solitaire variation.</TD></TR><TR><TD CLASS="l">256</TD><TD>         */</TD></TR><TR><TD CLASS="l">257</TD><TD>        public abstract String getName();</TD></TR><TR><TD CLASS="l">258</TD><TD> </TD></TR><TR><TD CLASS="l">259</TD><TD>        /**</TD></TR><TR><TD CLASS="l">260</TD><TD>         * Return the Element representing the number of cards left.</TD></TR><TR><TD CLASS="l">261</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="5">262</A></TD><TD>         * @return The MutableInteger Element storing the number of cards left to</TD></TR><TR><TD CLASS="l">263</TD><TD>         *         play.</TD></TR><TR><TD CLASS="l">264</TD><TD>         */</TD></TR><TR><TD CLASS="l">265</TD><TD>        public MutableInteger getNumLeft() {</TD></TR><TR CLASS="z"><TD CLASS="l">266</TD><TD>                return numLeft;</TD></TR><TR><TD CLASS="l">267</TD><TD>        }</TD></TR><TR><TD CLASS="l">268</TD><TD> </TD></TR><TR><TD CLASS="l">269</TD><TD>        /**</TD></TR><TR><TD CLASS="l">270</TD><TD>         * Returns the preferred size needed for this solitaire game to function.</TD></TR><TR><TD CLASS="l">271</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">272</TD><TD>         * Each subclass should override this method if more space is needed</TD></TR><TR><TD CLASS="l">273</TD><TD>         * initially when the solitaire version is initialized.</TD></TR><TR><TD CLASS="l">274</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">275</TD><TD>         * The default value returned is (769, 635).</TD></TR><TR><TD CLASS="l">276</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="1f">277</A></TD><TD>         * @return java.awt.Dimension the desired dimension of the game.</TD></TR><TR><TD CLASS="l">278</TD><TD>         */</TD></TR><TR><TD CLASS="l">279</TD><TD>        public Dimension getPreferredSize() {</TD></TR><TR><TD CLASS="l">280</TD><TD>                // default starting dimensions...</TD></TR><TR CLASS="c"><TD CLASS="l">281</TD><TD>                return new Dimension(769, 635);</TD></TR><TR><TD CLASS="l">282</TD><TD>        }</TD></TR><TR><TD CLASS="l">283</TD><TD> </TD></TR><TR><TD CLASS="l">284</TD><TD>        /**</TD></TR><TR><TD CLASS="l">285</TD><TD>         * Return the model Element representing the score for a solitaire game.</TD></TR><TR><TD CLASS="l"><A NAME="6">286</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">287</TD><TD>         * @return the MutableInteger Element representing the score for the game.</TD></TR><TR><TD CLASS="l">288</TD><TD>         */</TD></TR><TR><TD CLASS="l">289</TD><TD>        public MutableInteger getScore() {</TD></TR><TR CLASS="z"><TD CLASS="l">290</TD><TD>                return score;</TD></TR><TR><TD CLASS="l">291</TD><TD>        }</TD></TR><TR><TD CLASS="l">292</TD><TD> </TD></TR><TR><TD CLASS="l">293</TD><TD>        /**</TD></TR><TR><TD CLASS="l">294</TD><TD>         * Return the score for a solitaire game as an int.</TD></TR><TR><TD CLASS="l">295</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="7">296</A></TD><TD>         * @return int represents the value of the &lt;code&gt;score&lt;/code&gt;</TD></TR><TR><TD CLASS="l">297</TD><TD>         *         MutableInteger</TD></TR><TR><TD CLASS="l">298</TD><TD>         */</TD></TR><TR><TD CLASS="l">299</TD><TD>        public int getScoreValue() {</TD></TR><TR CLASS="z"><TD CLASS="l">300</TD><TD>                return score.getValue();</TD></TR><TR><TD CLASS="l">301</TD><TD>        }</TD></TR><TR><TD CLASS="l">302</TD><TD> </TD></TR><TR><TD CLASS="l">303</TD><TD>        /**</TD></TR><TR><TD CLASS="l">304</TD><TD>         * Return the random seed used to shuffle the deck.</TD></TR><TR><TD CLASS="l"><A NAME="8">305</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">306</TD><TD>         * @return int represents the seed used for randomization algorithms</TD></TR><TR><TD CLASS="l">307</TD><TD>         */</TD></TR><TR><TD CLASS="l">308</TD><TD>        public int getSeed() {</TD></TR><TR CLASS="z"><TD CLASS="l">309</TD><TD>                return seed;</TD></TR><TR><TD CLASS="l">310</TD><TD>        }</TD></TR><TR><TD CLASS="l">311</TD><TD> </TD></TR><TR><TD CLASS="l">312</TD><TD>        /**</TD></TR><TR><TD CLASS="l">313</TD><TD>         * Every Solitaire variation may support a version. By default, this will</TD></TR><TR><TD CLASS="l">314</TD><TD>         * always return &#34;1.0&#34;;</TD></TR><TR><TD CLASS="l"><A NAME="9">315</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">316</TD><TD>         * @return String</TD></TR><TR><TD CLASS="l">317</TD><TD>         */</TD></TR><TR><TD CLASS="l">318</TD><TD>        public String getVersion() {</TD></TR><TR CLASS="z"><TD CLASS="l">319</TD><TD>                return &#34;1.0&#34;;</TD></TR><TR><TD CLASS="l">320</TD><TD>        }</TD></TR><TR><TD CLASS="l">321</TD><TD> </TD></TR><TR><TD CLASS="l">322</TD><TD>        /**</TD></TR><TR><TD CLASS="l">323</TD><TD>         * Returns Enumeration of all Widgets maintained by this Solitaire</TD></TR><TR><TD CLASS="l">324</TD><TD>         * variation.</TD></TR><TR><TD CLASS="l"><A NAME="a">325</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">326</TD><TD>         * @return Enumeration of Element objects.</TD></TR><TR><TD CLASS="l">327</TD><TD>         */</TD></TR><TR><TD CLASS="l">328</TD><TD>        public Enumeration&lt;Widget&gt; getWidgets() {</TD></TR><TR CLASS="z"><TD CLASS="l">329</TD><TD>                if (container == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">330</TD><TD>                        throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">331</TD><TD>                                        &#34;Solitaire::getWidgets() invoked with null Container.&#34;);</TD></TR><TR><TD CLASS="l">332</TD><TD>                }</TD></TR><TR><TD CLASS="l">333</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">334</TD><TD>                return container.getWidgets();</TD></TR><TR><TD CLASS="l">335</TD><TD>        }</TD></TR><TR><TD CLASS="l">336</TD><TD> </TD></TR><TR><TD CLASS="l">337</TD><TD>        /**</TD></TR><TR><TD CLASS="l">338</TD><TD>         * Each solitaire game knows when it has won.</TD></TR><TR><TD CLASS="l">339</TD><TD>         * </TD></TR><TR><TD CLASS="l">340</TD><TD>         * @return boolean true if the player has won the game.</TD></TR><TR><TD CLASS="l">341</TD><TD>         */</TD></TR><TR><TD CLASS="l">342</TD><TD>        abstract public boolean hasWon();</TD></TR><TR><TD CLASS="l">343</TD><TD> </TD></TR><TR><TD CLASS="l">344</TD><TD>        /**</TD></TR><TR><TD CLASS="l">345</TD><TD>         * Each solitaire game provides its own initialization routine.</TD></TR><TR><TD CLASS="l">346</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">347</TD><TD>         * By the time this method is called, the game is part of its Container.</TD></TR><TR><TD CLASS="l">348</TD><TD>         */</TD></TR><TR><TD CLASS="l">349</TD><TD>        abstract public void initialize();</TD></TR><TR><TD CLASS="l">350</TD><TD> </TD></TR><TR><TD CLASS="l">351</TD><TD>        /**</TD></TR><TR><TD CLASS="l"><A NAME="b">352</A></TD><TD>         * Update seed by a specific amount and restart solitaire game.</TD></TR><TR><TD CLASS="l">353</TD><TD>         */</TD></TR><TR><TD CLASS="l">354</TD><TD>        public void nextHand() {</TD></TR><TR><TD CLASS="l">355</TD><TD>                // update seed value.</TD></TR><TR CLASS="z"><TD CLASS="l">356</TD><TD>                seed += getIncrement();</TD></TR><TR><TD CLASS="l">357</TD><TD> </TD></TR><TR><TD CLASS="l">358</TD><TD>                // start over</TD></TR><TR CLASS="z"><TD CLASS="l">359</TD><TD>                resetHand();</TD></TR><TR CLASS="z"><TD CLASS="l">360</TD><TD>        }</TD></TR><TR><TD CLASS="l">361</TD><TD> </TD></TR><TR><TD CLASS="l">362</TD><TD>        /**</TD></TR><TR><TD CLASS="l">363</TD><TD>         * Returns most recent move and removes it from list of Moves.</TD></TR><TR><TD CLASS="l">364</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">365</TD><TD>         * If there are no moves present in this game, null is returned.</TD></TR><TR><TD CLASS="l">366</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">367</TD><TD>         * This method must be protected since only &lt;code&gt;undoMove()&lt;/code&gt; should</TD></TR><TR><TD CLASS="l">368</TD><TD>         * have access.</TD></TR><TR><TD CLASS="l">369</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">370</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="c">371</A></TD><TD>         * @return the most recent Move made in this solitaire game.</TD></TR><TR><TD CLASS="l">372</TD><TD>         */</TD></TR><TR><TD CLASS="l">373</TD><TD>        protected Move popMove() {</TD></TR><TR><TD CLASS="l">374</TD><TD>                // Return null if the stack of moves is empty.</TD></TR><TR CLASS="z"><TD CLASS="l">375</TD><TD>                if (moves.isEmpty())</TD></TR><TR CLASS="z"><TD CLASS="l">376</TD><TD>                        return null;</TD></TR><TR><TD CLASS="l">377</TD><TD> </TD></TR><TR><TD CLASS="l">378</TD><TD>                // pop most recent.</TD></TR><TR CLASS="z"><TD CLASS="l">379</TD><TD>                return (Move) moves.pop();</TD></TR><TR><TD CLASS="l">380</TD><TD>        }</TD></TR><TR><TD CLASS="l">381</TD><TD> </TD></TR><TR><TD CLASS="l">382</TD><TD>        /**</TD></TR><TR><TD CLASS="l">383</TD><TD>         * Pushes given move onto our stack of existing moves.</TD></TR><TR><TD CLASS="l">384</TD><TD>         * </TD></TR><TR><TD CLASS="l">385</TD><TD>         * @return boolean</TD></TR><TR><TD CLASS="l">386</TD><TD>         * @param m</TD></TR><TR><TD CLASS="l"><A NAME="d">387</A></TD><TD>         *            A Move object representing the most recent Move made in the</TD></TR><TR><TD CLASS="l">388</TD><TD>         *            solitaire game.</TD></TR><TR><TD CLASS="l">389</TD><TD>         */</TD></TR><TR><TD CLASS="l">390</TD><TD>        public boolean pushMove(Move m) {</TD></TR><TR CLASS="z"><TD CLASS="l">391</TD><TD>                moves.push(m);</TD></TR><TR CLASS="z"><TD CLASS="l">392</TD><TD>                return true;</TD></TR><TR><TD CLASS="l">393</TD><TD>        }</TD></TR><TR><TD CLASS="l">394</TD><TD> </TD></TR><TR><TD CLASS="l">395</TD><TD>        /**</TD></TR><TR><TD CLASS="l"><A NAME="20">396</A></TD><TD>         * Refresh all elements whose Widgets are now dirty. Also redraw background.</TD></TR><TR><TD CLASS="l">397</TD><TD>         * Not all Widgets are redrawn.</TD></TR><TR><TD CLASS="l">398</TD><TD>         */</TD></TR><TR><TD CLASS="l">399</TD><TD>        public void refreshAll() {</TD></TR><TR CLASS="c"><TD CLASS="l">400</TD><TD>                container.refreshAll();</TD></TR><TR CLASS="c"><TD CLASS="l">401</TD><TD>        }</TD></TR><TR><TD CLASS="l">402</TD><TD> </TD></TR><TR><TD CLASS="l">403</TD><TD>        /**</TD></TR><TR><TD CLASS="l"><A NAME="e">404</A></TD><TD>         * Refresh all elements whose Widgets are now dirty. Not all Widgets are</TD></TR><TR><TD CLASS="l">405</TD><TD>         * redrawn.</TD></TR><TR><TD CLASS="l">406</TD><TD>         */</TD></TR><TR><TD CLASS="l">407</TD><TD>        public void refreshWidgets() {</TD></TR><TR CLASS="z"><TD CLASS="l">408</TD><TD>                container.refreshWidgets();</TD></TR><TR CLASS="z"><TD CLASS="l">409</TD><TD>        }</TD></TR><TR><TD CLASS="l">410</TD><TD> </TD></TR><TR><TD CLASS="l">411</TD><TD>        /**</TD></TR><TR><TD CLASS="l">412</TD><TD>         * Refresh all elements whose Widgets are now dirty. Not all Widgets are</TD></TR><TR><TD CLASS="l">413</TD><TD>         * redrawn.</TD></TR><TR><TD CLASS="l">414</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">415</TD><TD>         * Clip to only refresh widgets whose view intersects the clip rectangle.</TD></TR><TR><TD CLASS="l">416</TD><TD>         * [clip is unaffected by this invocation. ]</TD></TR><TR><TD CLASS="l">417</TD><TD>         * </TD></TR><TR><TD CLASS="l">418</TD><TD>         * @param clip</TD></TR><TR><TD CLASS="l"><A NAME="f">419</A></TD><TD>         *            a Rectangle representing the region outside of which no</TD></TR><TR><TD CLASS="l">420</TD><TD>         *            drawing occurs.</TD></TR><TR><TD CLASS="l">421</TD><TD>         */</TD></TR><TR><TD CLASS="l">422</TD><TD>        public void refreshWidgets(Rectangle clip) {</TD></TR><TR CLASS="z"><TD CLASS="l">423</TD><TD>                container.refreshWidgets(clip);</TD></TR><TR CLASS="z"><TD CLASS="l">424</TD><TD>        }</TD></TR><TR><TD CLASS="l">425</TD><TD> </TD></TR><TR><TD CLASS="l">426</TD><TD>        /**</TD></TR><TR><TD CLASS="l">427</TD><TD>         * Forces entire game to be repainted, whether a View needs it or not.</TD></TR><TR><TD CLASS="l">428</TD><TD>         * Background is redrawn.</TD></TR><TR><TD CLASS="l">429</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">430</TD><TD>         * Note that if you call container.repaint() the entire background is</TD></TR><TR><TD CLASS="l"><A NAME="21">431</A></TD><TD>         * re-filled with the background color, introducing flicker. The</TD></TR><TR><TD CLASS="l">432</TD><TD>         * repaintAll() method is our own protocol that avoids this flicker.</TD></TR><TR><TD CLASS="l">433</TD><TD>         */</TD></TR><TR><TD CLASS="l">434</TD><TD>        public void repaintAll() {</TD></TR><TR CLASS="c"><TD CLASS="l">435</TD><TD>                container.repaintAll();</TD></TR><TR CLASS="c"><TD CLASS="l">436</TD><TD>        }</TD></TR><TR><TD CLASS="l">437</TD><TD> </TD></TR><TR><TD CLASS="l">438</TD><TD>        /**</TD></TR><TR><TD CLASS="l">439</TD><TD>         * Forces entire game to be repainted, whether a View needs it or not.</TD></TR><TR><TD CLASS="l">440</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">441</TD><TD>         * Restrict drawing to the clip Rectangle. [clip is unaffected by this</TD></TR><TR><TD CLASS="l">442</TD><TD>         * invocation].</TD></TR><TR><TD CLASS="l">443</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">444</TD><TD>         * Note that if you call container.repaint() the entire background is</TD></TR><TR><TD CLASS="l">445</TD><TD>         * re-filled with the background color, introducing flicker. The</TD></TR><TR><TD CLASS="l">446</TD><TD>         * repaintAll() method is our own protocol that avoids this flicker.</TD></TR><TR><TD CLASS="l">447</TD><TD>         * </TD></TR><TR><TD CLASS="l">448</TD><TD>         * @param clip</TD></TR><TR><TD CLASS="l"><A NAME="10">449</A></TD><TD>         *            a Rectangle representing the region outside of which no</TD></TR><TR><TD CLASS="l">450</TD><TD>         *            drawing occurs.</TD></TR><TR><TD CLASS="l">451</TD><TD>         */</TD></TR><TR><TD CLASS="l">452</TD><TD>        public void repaintAll(Rectangle clip) {</TD></TR><TR CLASS="z"><TD CLASS="l">453</TD><TD>                container.repaintAll(clip);</TD></TR><TR CLASS="z"><TD CLASS="l">454</TD><TD>        }</TD></TR><TR><TD CLASS="l">455</TD><TD> </TD></TR><TR><TD CLASS="l">456</TD><TD>        /**</TD></TR><TR><TD CLASS="l">457</TD><TD>         * Repaint all Widgets, whether they need to be redrawn or not.</TD></TR><TR><TD CLASS="l">458</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">459</TD><TD>         * Clip to only refresh widgets whose view intersects the clip rectangle.</TD></TR><TR><TD CLASS="l">460</TD><TD>         * [clip is unaffected by this invocation.]</TD></TR><TR><TD CLASS="l">461</TD><TD>         * </TD></TR><TR><TD CLASS="l">462</TD><TD>         * @param clip</TD></TR><TR><TD CLASS="l"><A NAME="12">463</A></TD><TD>         *            a Rectangle representing the region outside of which no</TD></TR><TR><TD CLASS="l">464</TD><TD>         *            drawing occurs.</TD></TR><TR><TD CLASS="l">465</TD><TD>         */</TD></TR><TR><TD CLASS="l">466</TD><TD>        public void repaintWidgets(Rectangle clip) {</TD></TR><TR CLASS="z"><TD CLASS="l">467</TD><TD>                container.repaintWidgets(clip);</TD></TR><TR CLASS="z"><TD CLASS="l">468</TD><TD>        }</TD></TR><TR><TD CLASS="l">469</TD><TD> </TD></TR><TR><TD CLASS="l">470</TD><TD>        /**</TD></TR><TR><TD CLASS="l">471</TD><TD>         * User has requested to play hand again.</TD></TR><TR><TD CLASS="l"><A NAME="1a">472</A></TD><TD>         */</TD></TR><TR><TD CLASS="l">473</TD><TD>        public void resetHand() {</TD></TR><TR><TD CLASS="l">474</TD><TD> </TD></TR><TR><TD CLASS="l">475</TD><TD>                // remove all widgets from the container.</TD></TR><TR CLASS="c"><TD CLASS="l">476</TD><TD>                Container c = getContainer();</TD></TR><TR CLASS="c"><TD CLASS="l">477</TD><TD>                if (c == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">478</TD><TD>                        System.err.println(&#34;Solitaire::resetHand(): Container is unexpectedly null.&#34;);</TD></TR><TR CLASS="z"><TD CLASS="l">479</TD><TD>                        return;</TD></TR><TR><TD CLASS="l">480</TD><TD>                }</TD></TR><TR><TD CLASS="l">481</TD><TD> </TD></TR><TR><TD CLASS="l">482</TD><TD>                // remove all widgets and model elements to start fresh</TD></TR><TR CLASS="c"><TD CLASS="l">483</TD><TD>                c.removeAllWidgets();</TD></TR><TR CLASS="c"><TD CLASS="l">484</TD><TD>                model.removeAllElements();</TD></TR><TR><TD CLASS="l">485</TD><TD> </TD></TR><TR><TD CLASS="l">486</TD><TD>                // reset moves</TD></TR><TR CLASS="c"><TD CLASS="l">487</TD><TD>                moves = new java.util.Stack&lt;Move&gt;();</TD></TR><TR><TD CLASS="l">488</TD><TD> </TD></TR><TR><TD CLASS="l">489</TD><TD>                // set score and numCardsLeft</TD></TR><TR CLASS="c"><TD CLASS="l">490</TD><TD>                setScore();</TD></TR><TR CLASS="c"><TD CLASS="l">491</TD><TD>                setNumberCardsLeft();</TD></TR><TR><TD CLASS="l">492</TD><TD>                </TD></TR><TR><TD CLASS="l">493</TD><TD>                // Finally, cover the Container for any events not handled by a widget:</TD></TR><TR CLASS="c"><TD CLASS="l">494</TD><TD>                c.setMouseMotionAdapter(new SolitaireMouseMotionAdapter(this));</TD></TR><TR CLASS="c"><TD CLASS="l">495</TD><TD>                c.setUndoAdapter (new SolitaireUndoAdapter(this));</TD></TR><TR CLASS="c"><TD CLASS="l">496</TD><TD>                c.setMouseAdapter (new SolitaireReleasedAdapter(this));</TD></TR><TR><TD CLASS="l">497</TD><TD>                </TD></TR><TR><TD CLASS="l">498</TD><TD>                // re-initialize and redraw everything</TD></TR><TR CLASS="c"><TD CLASS="l">499</TD><TD>                updateGameInformationFromContainer(c);</TD></TR><TR CLASS="c"><TD CLASS="l">500</TD><TD>                initialize();</TD></TR><TR CLASS="c"><TD CLASS="l">501</TD><TD>                refreshAll();</TD></TR><TR CLASS="c"><TD CLASS="l">502</TD><TD>        }</TD></TR><TR><TD CLASS="l">503</TD><TD> </TD></TR><TR><TD CLASS="l">504</TD><TD>        /**</TD></TR><TR><TD CLASS="l">505</TD><TD>         * Set the container in which this Solitaire game will be displayed and be</TD></TR><TR><TD CLASS="l">506</TD><TD>         * active.</TD></TR><TR><TD CLASS="l">507</TD><TD>         * </TD></TR><TR><TD CLASS="l">508</TD><TD>         * New to V2.2 some solitaire variations need to know the number</TD></TR><TR><TD CLASS="l">509</TD><TD>         * of players that are currently playing. Since this information</TD></TR><TR><TD CLASS="l">510</TD><TD>         * can be determined from the container, it only makes sense to</TD></TR><TR><TD CLASS="l">511</TD><TD>         * update that information upon set.</TD></TR><TR><TD CLASS="l">512</TD><TD>         * </TD></TR><TR><TD CLASS="l">513</TD><TD>         * Note that when a game is restarted, this information may </TD></TR><TR><TD CLASS="l">514</TD><TD>         * indeed be invalid, so we take care to do this right.</TD></TR><TR><TD CLASS="l"><A NAME="22">515</A></TD><TD>         * </TD></TR><TR><TD CLASS="l">516</TD><TD>         * @param cont     the Container in which this solitaire game will be executed.</TD></TR><TR><TD CLASS="l">517</TD><TD>         */</TD></TR><TR><TD CLASS="l">518</TD><TD>        public void setContainer(Container cont) {</TD></TR><TR CLASS="c"><TD CLASS="l">519</TD><TD>                container = cont;</TD></TR><TR CLASS="c"><TD CLASS="l">520</TD><TD>                updateGameInformationFromContainer(container);</TD></TR><TR CLASS="c"><TD CLASS="l">521</TD><TD>        }</TD></TR><TR><TD CLASS="l">522</TD><TD> </TD></TR><TR><TD CLASS="l">523</TD><TD>        /**</TD></TR><TR><TD CLASS="l">524</TD><TD>         * Some solitaire variations need to know specific information</TD></TR><TR><TD CLASS="l">525</TD><TD>         * regarding the number of players on a table, for instance.</TD></TR><TR><TD CLASS="l">526</TD><TD>         * </TD></TR><TR><TD CLASS="l">527</TD><TD>         * This method is invoked exactly once at the beginning of</TD></TR><TR><TD CLASS="l">528</TD><TD>         * a game's initialization.</TD></TR><TR><TD CLASS="l">529</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="25">530</A></TD><TD>         * Subclasses should override this method.</TD></TR><TR><TD CLASS="l">531</TD><TD>         */</TD></TR><TR><TD CLASS="l">532</TD><TD>        protected void updateGameInformationFromContainer(Container c) {</TD></TR><TR><TD CLASS="l">533</TD><TD>                // noop. Done to avoid forcing subclasses to implement noop if not needed.</TD></TR><TR CLASS="c"><TD CLASS="l">534</TD><TD>        }</TD></TR><TR><TD CLASS="l">535</TD><TD> </TD></TR><TR><TD CLASS="l">536</TD><TD>        </TD></TR><TR><TD CLASS="l">537</TD><TD>        /**</TD></TR><TR><TD CLASS="l">538</TD><TD>         * Set the value for incrementing deck seed.</TD></TR><TR><TD CLASS="l">539</TD><TD>         * </TD></TR><TR><TD CLASS="l">540</TD><TD>         * @param newIncrement</TD></TR><TR><TD CLASS="l"><A NAME="23">541</A></TD><TD>         *            an integer representing the value to add to the random seed</TD></TR><TR><TD CLASS="l">542</TD><TD>         *            when generating successive solitaire deals.</TD></TR><TR><TD CLASS="l">543</TD><TD>         */</TD></TR><TR><TD CLASS="l">544</TD><TD>        public void setIncrement(int newIncrement) {</TD></TR><TR CLASS="c"><TD CLASS="l">545</TD><TD>                increment = newIncrement;</TD></TR><TR CLASS="c"><TD CLASS="l">546</TD><TD>        }</TD></TR><TR><TD CLASS="l">547</TD><TD> </TD></TR><TR><TD CLASS="l">548</TD><TD>        /**</TD></TR><TR><TD CLASS="l">549</TD><TD>         * Set the model element for number of cards left.</TD></TR><TR><TD CLASS="l">550</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l"><A NAME="18">551</A></TD><TD>         * If this method is called multiple times, only the value is transferred to</TD></TR><TR><TD CLASS="l">552</TD><TD>         * the existing model element &lt;code&gt;numLeft&lt;/code&gt;.</TD></TR><TR><TD CLASS="l">553</TD><TD>         */</TD></TR><TR><TD CLASS="l">554</TD><TD>        private void setNumberCardsLeft() {</TD></TR><TR CLASS="c"><TD CLASS="l">555</TD><TD>                MutableInteger mu = new MutableInteger (numLeftName, 0);</TD></TR><TR CLASS="c"><TD CLASS="l">556</TD><TD>                if (model.addElement(mu) == false) {</TD></TR><TR><TD CLASS="l">557</TD><TD>                        // just extract value and replace. This invocation will generate a</TD></TR><TR><TD CLASS="l">558</TD><TD>                        // stateChange event.</TD></TR><TR CLASS="z"><TD CLASS="l">559</TD><TD>                        numLeft.setValue(mu.getValue());</TD></TR><TR><TD CLASS="l">560</TD><TD>                } else {</TD></TR><TR><TD CLASS="l">561</TD><TD>                        // otherwise, must set.</TD></TR><TR CLASS="c"><TD CLASS="l">562</TD><TD>                        numLeft = mu;</TD></TR><TR><TD CLASS="l">563</TD><TD>                }</TD></TR><TR CLASS="c"><TD CLASS="l">564</TD><TD>        }</TD></TR><TR><TD CLASS="l">565</TD><TD> </TD></TR><TR><TD CLASS="l">566</TD><TD>        /**</TD></TR><TR><TD CLASS="l">567</TD><TD>         * Set the model element for score of the game.</TD></TR><TR><TD CLASS="l">568</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l"><A NAME="19">569</A></TD><TD>         * If this method is called multiple times, only the value is transferred to</TD></TR><TR><TD CLASS="l">570</TD><TD>         * the existing model element &lt;code&gt;score&lt;/code&gt;.</TD></TR><TR><TD CLASS="l">571</TD><TD>         */</TD></TR><TR><TD CLASS="l">572</TD><TD>        private void setScore() {</TD></TR><TR CLASS="c"><TD CLASS="l">573</TD><TD>                MutableInteger mu = new MutableInteger (scoreName, 0);</TD></TR><TR CLASS="c"><TD CLASS="l">574</TD><TD>                if (model.addElement(mu) == false) {</TD></TR><TR><TD CLASS="l">575</TD><TD>                        // we already have a score, so transfer value. This </TD></TR><TR><TD CLASS="l">576</TD><TD>                        // invocation will                        // generate a stateChange event.</TD></TR><TR CLASS="z"><TD CLASS="l">577</TD><TD>                        score.setValue(mu.getValue());</TD></TR><TR><TD CLASS="l">578</TD><TD>                } else {</TD></TR><TR CLASS="c"><TD CLASS="l">579</TD><TD>                        score = mu;</TD></TR><TR><TD CLASS="l">580</TD><TD>                }</TD></TR><TR CLASS="c"><TD CLASS="l">581</TD><TD>        }</TD></TR><TR><TD CLASS="l">582</TD><TD> </TD></TR><TR><TD CLASS="l">583</TD><TD>        /**</TD></TR><TR><TD CLASS="l">584</TD><TD>         * Set seed value for this game.</TD></TR><TR><TD CLASS="l">585</TD><TD>         * </TD></TR><TR><TD CLASS="l">586</TD><TD>         * @param seed</TD></TR><TR><TD CLASS="l"><A NAME="24">587</A></TD><TD>         *            an integer representing the seed for the randomization</TD></TR><TR><TD CLASS="l">588</TD><TD>         *            algorithm</TD></TR><TR><TD CLASS="l">589</TD><TD>         */</TD></TR><TR><TD CLASS="l">590</TD><TD>        public void setSeed(int seed) {</TD></TR><TR CLASS="c"><TD CLASS="l">591</TD><TD>                this.seed = seed;</TD></TR><TR CLASS="c"><TD CLASS="l">592</TD><TD>        }</TD></TR><TR><TD CLASS="l">593</TD><TD> </TD></TR><TR><TD CLASS="l">594</TD><TD>        /**</TD></TR><TR><TD CLASS="l">595</TD><TD>         * Solitaire game stores all moves and enables them to be undone. Once a</TD></TR><TR><TD CLASS="l">596</TD><TD>         * request to undo is received, this takes care of it.</TD></TR><TR><TD CLASS="l">597</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="13">598</A></TD><TD>         * @return boolean true means the move was successfully undone; false</TD></TR><TR><TD CLASS="l">599</TD><TD>         *         otherwise.</TD></TR><TR><TD CLASS="l">600</TD><TD>         */</TD></TR><TR><TD CLASS="l">601</TD><TD>        public boolean undoMove() {</TD></TR><TR CLASS="z"><TD CLASS="l">602</TD><TD>                Move m = popMove();</TD></TR><TR><TD CLASS="l">603</TD><TD>                // unable to undo</TD></TR><TR CLASS="z"><TD CLASS="l">604</TD><TD>                if (m == null) {</TD></TR><TR><TD CLASS="l">605</TD><TD>                        // signal our disapproval.</TD></TR><TR CLASS="z"><TD CLASS="l">606</TD><TD>                        java.awt.Toolkit.getDefaultToolkit().beep();</TD></TR><TR CLASS="z"><TD CLASS="l">607</TD><TD>                        return false;</TD></TR><TR><TD CLASS="l">608</TD><TD>                }</TD></TR><TR><TD CLASS="l">609</TD><TD> </TD></TR><TR><TD CLASS="l">610</TD><TD>                // Undo and refresh all widgets.</TD></TR><TR CLASS="z"><TD CLASS="l">611</TD><TD>                boolean status = m.undo(this);</TD></TR><TR CLASS="z"><TD CLASS="l">612</TD><TD>                if (status) {</TD></TR><TR CLASS="z"><TD CLASS="l">613</TD><TD>                        refreshWidgets();</TD></TR><TR><TD CLASS="l">614</TD><TD>                } else {</TD></TR><TR><TD CLASS="l">615</TD><TD>                        // if we can't undo the move, we push it back onto the stack</TD></TR><TR CLASS="z"><TD CLASS="l">616</TD><TD>                        pushMove(m);</TD></TR><TR><TD CLASS="l">617</TD><TD>                }</TD></TR><TR><TD CLASS="l">618</TD><TD> </TD></TR><TR><TD CLASS="l">619</TD><TD>                // return results.</TD></TR><TR CLASS="z"><TD CLASS="l">620</TD><TD>                return status;</TD></TR><TR><TD CLASS="l">621</TD><TD>        }</TD></TR><TR><TD CLASS="l">622</TD><TD> </TD></TR><TR><TD CLASS="l">623</TD><TD>        /**</TD></TR><TR><TD CLASS="l">624</TD><TD>         * Add delta to the number of cards left. If delta is negative, we are</TD></TR><TR><TD CLASS="l">625</TD><TD>         * removing cards.</TD></TR><TR><TD CLASS="l">626</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">627</TD><TD>         * There is no check on the value</TD></TR><TR><TD CLASS="l">628</TD><TD>         * </TD></TR><TR><TD CLASS="l">629</TD><TD>         * @param delta</TD></TR><TR><TD CLASS="l">630</TD><TD>         *            an integer representing the value to add to the number of</TD></TR><TR><TD CLASS="l"><A NAME="14">631</A></TD><TD>         *            cards left. A negative number means reduce the number of cards</TD></TR><TR><TD CLASS="l">632</TD><TD>         *            left.</TD></TR><TR><TD CLASS="l">633</TD><TD>         */</TD></TR><TR><TD CLASS="l">634</TD><TD>        public void updateNumberCardsLeft(int delta) {</TD></TR><TR CLASS="z"><TD CLASS="l">635</TD><TD>                numLeft.setValue(numLeft.getValue() + delta);</TD></TR><TR CLASS="z"><TD CLASS="l">636</TD><TD>        }</TD></TR><TR><TD CLASS="l">637</TD><TD> </TD></TR><TR><TD CLASS="l">638</TD><TD>        /**</TD></TR><TR><TD CLASS="l">639</TD><TD>         * Add delta to the score. If delta is negative, we are removing points.</TD></TR><TR><TD CLASS="l">640</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">641</TD><TD>         * There is no check on the score value.</TD></TR><TR><TD CLASS="l">642</TD><TD>         * </TD></TR><TR><TD CLASS="l">643</TD><TD>         * @param delta</TD></TR><TR><TD CLASS="l"><A NAME="15">644</A></TD><TD>         *            an integer representing the value to add to player's score. A</TD></TR><TR><TD CLASS="l">645</TD><TD>         *            negative number means lower the score.</TD></TR><TR><TD CLASS="l">646</TD><TD>         */</TD></TR><TR><TD CLASS="l">647</TD><TD>        public void updateScore(int delta) {</TD></TR><TR CLASS="z"><TD CLASS="l">648</TD><TD>                int sc = score.getValue() + delta;</TD></TR><TR CLASS="z"><TD CLASS="l">649</TD><TD>                score.setValue(sc);</TD></TR><TR><TD CLASS="l">650</TD><TD>                </TD></TR><TR><TD CLASS="l">651</TD><TD>                // update changes</TD></TR><TR CLASS="z"><TD CLASS="l">652</TD><TD>        container.updateScore(sc);</TD></TR><TR CLASS="z"><TD CLASS="l">653</TD><TD>        }</TD></TR><TR><TD CLASS="l">654</TD><TD> </TD></TR><TR><TD CLASS="l">655</TD><TD>        /**</TD></TR><TR><TD CLASS="l">656</TD><TD>         * Standard Configuration.getValue(deckTypeVariable) contains deck type.</TD></TR><TR><TD CLASS="l">657</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">658</TD><TD>         * Note: overload this method if your plugin requires a different deck type.</TD></TR><TR><TD CLASS="l">659</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">660</TD><TD>         * Note: this method is a bit of a hack since it uses the global</TD></TR><TR><TD CLASS="l">661</TD><TD>         * Configuration information. Ideally, this should be moved out and 'set'</TD></TR><TR><TD CLASS="l">662</TD><TD>         * from the outside instead of 'get' from here in the inside. Ah well...</TD></TR><TR><TD CLASS="l">663</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">664</TD><TD>         * </TD></TR><TR><TD CLASS="l"><A NAME="1e">665</A></TD><TD>         * @since V2.1</TD></TR><TR><TD CLASS="l">666</TD><TD>         * @return String deckType to use for this plugin.</TD></TR><TR><TD CLASS="l">667</TD><TD>         */</TD></TR><TR><TD CLASS="l">668</TD><TD>        public String getDeckType() {</TD></TR><TR CLASS="c"><TD CLASS="l">669</TD><TD>                return defaultDeckType;</TD></TR><TR><TD CLASS="l">670</TD><TD>        }</TD></TR><TR><TD CLASS="l">671</TD><TD> </TD></TR><TR><TD CLASS="l">672</TD><TD>        /**</TD></TR><TR><TD CLASS="l">673</TD><TD>         * Forces only background within clipping rectangle to be redrawn.</TD></TR><TR><TD CLASS="l">674</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">675</TD><TD>         * Restrict drawing to the clip Rectangle. [clip is unaffected by this</TD></TR><TR><TD CLASS="l">676</TD><TD>         * invocation].</TD></TR><TR><TD CLASS="l">677</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">678</TD><TD>         * </TD></TR><TR><TD CLASS="l">679</TD><TD>         * @param clip</TD></TR><TR><TD CLASS="l"><A NAME="11">680</A></TD><TD>         *            a Rectangle representing the region outside of which no</TD></TR><TR><TD CLASS="l">681</TD><TD>         *            drawing occurs.</TD></TR><TR><TD CLASS="l">682</TD><TD>         */</TD></TR><TR><TD CLASS="l">683</TD><TD>        public void repaintBackground(Rectangle clip) {</TD></TR><TR CLASS="z"><TD CLASS="l">684</TD><TD>                container.repaintBackground(clip);</TD></TR><TR CLASS="z"><TD CLASS="l">685</TD><TD>        }</TD></TR><TR><TD CLASS="l">686</TD><TD>}</TD></TR></TABLE><P></P><TABLE CLASS="hdft" CELLSPACING="0" WIDTH="100%"><TR><TD CLASS="nv">[<A HREF="../Framework-12-17.html">all classes</A>][<A HREF="24.html">ks.common.games</A>]</TD></TR><TR><TD CLASS="tl"><A HREF="http://www.eclemma.org/support.html">EMMA 2.0.5312 EclEmma Fix 1</A> (C) Vladimir Roubtsov</TD></TR></TABLE></BODY></HTML>